JNI 编程上手指南之描述符

7/3/2023

# 1. 类描述符

在 JNI 的 Native 方法中,我们要使用 Java 中的对象怎么办?即在 C/C++ 中怎么找到 Java 中的类,这就要使用到 JNI 开发中的类描述符了

JNI 提供的函数中有个 FindClass() 就是用来查找 Java 类的,其参数必须放入一个类描述符字符串,类描述符一般是类的完整名称(包名+类名)

一个 Java 类对应的描述符,就是类的全名,其中 . 要换成 / :

完整类名:   java.lang.String
对应类描述符: java/lang/String

jclass intArrCls = env->FindClass(“java/lang/String”)

jclass clazz = FindClassOrDie(env, "android/view/Surface");
1
2
3
4
5
6

# 2. 域描述符

域描述符是 JNI 中对 Java 数据类型的一种表示方法。在 JVM 虚拟机中,存储数据类型的名称时,是使用指定的描述符来存储,而不是我们习惯的 int,float 等。

虽然有类描述符,但是类描述符里并没有说明基本类型和数组类型如何表示,所以在 JNI 中就引入了域描述符的概念。

接着我们通过一个表格来了解域描述符的定义:

类型标识 Java数据类型
Z boolean
B byte
C char
S short
I int
J long
F float
D double
L包名/类名; 各种引用类型
V void
[ 数组
方法 (参数)返回值

接着我们来看几个例子:

Java类型:  java.lang.String
JNI 域描述符:Ljava/lang/String;  //注意结尾有分号

Java类型:   int[]
JNI域描述符: [I

Java类型:   float[]
JNI域描述符: [F

Java类型:   String[]
JNI域描述符: [Ljava/lang/String;

Java类型:   Object[]
JNI域描述符: [Ljava/lang/Object;

Java类型:   int[][]
JNI域描述符: [[I

Java类型:   float[][]
JNI域描述符: [[F
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

# 3. 方法描述符

方法描述符是 JVM 中对函数(方法)的标记方式,看几个例子就能基本掌握其命名特点了:

Java 方法                               方法描述符

String fun()                            ()Ljava/lang/String;
int fun(int i, Object object)           (ILjava/lang/Object;)I
void fun(byte[] bytes)                  ([B)V
int fun(byte data1, byte data2)         (BB)I
void fun()                              ()V
1
2
3
4
5
6
7